DNET WTCP Stack Selection API 


Version 1.0 
March 6, 2008 


PLEASE REVIEW THE TERMS OF THE FOUNDATION API LICENSE VERSION 1.0 
BEFORE READING THIS DOCUMENT. 


You may view the Foundation API License v1.0 at: 


http://www.limofoundation.org/images/stories/pdf/limo foundation api license vl-0.pdf 


This is an agreement between you (“You”) and LiMo Foundation related to the use of the APIs contained 
within this document. By accessing, downloading, reading or otherwise using the APIs contained within 
this document, You accept the terms of the Foundation API License v1.0. If You do not agree to the terms 
of this agreement, do not download, read and/or otherwise use any of the APIs. 


If You are agreeing to be bound by the Foundation API License v1.0 on behalf of your employer, You 
represent and warrant that you have full legal authority to bind your employer to this agreement. If You 
do not have the requisite authority, You may not download, read and/or otherwise use any of the APIs on 
behalf of your employer. 


© Copyright LiMo Foundation 2007, 2008. All rights reserved. 


NOTICES 


This document and the technical information it contains is subject to change by LiMo Foundation and 
its members at any time without notice as authorized by LiMo Foundation bylaws and other documents 
governing LiMo Foundation, including amendments thereto. All statements regarding LiMo’s future 
direction or intent are subject to change or withdrawal without notice, and represent goals and objectives 
only. 


Any reference in this document to non-LiMo Foundation Web sites do not in any manner serve as an 
endorsement of those Web sites. The materials at those Web sites are not part of this document or any 
product described in this document and use of those Web sites is at your own risk. 


Information concerning non-LiMo products was obtained from the suppliers of those products or a public 
announcement or source. LiMo cannot confirm the accuracy of that information or the performance, 
compatibility or any other claims related to non-LiMo products. 


All names or other identifying information used in examples in this document are fictitious and any 
similarity to the names or other identifying information of an actual person or organization is entirely 
coincidental. 


THIS DOCUMENT AND ALL INFORMATION IN THIS DOCUMENT ARE PROVIDED “AS IS”, 
WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OR CONDITION, INCLUDING, BUT 
NOT LIMITED TO, ANY WARRANTY OR CONDITION OF ACCURACY OR COMPLETENESS, 
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. 
ALL EXPRESS AND IMPLIED STATUTORY WARRANTIES ARE DISCLAIMED, INCLUDING 
WITHOUT LIMITATION, THE WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICU- 
LAR PURPOSE, TITLE OR NON-INFRINGEMENT. 
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Chapter 1 


DNET WTCP Stack Selection API 


1.1 


References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 


Overview 


This API is for selecting between TCP/WTCP stacks in a dual stack system (if supported). 


1.3 


Industry Standard 


IETF RFC 3481, "TCP over Second (2.5G) and Third (3G) Generation Wireless Networks", 
http://www.ietf.org/rfc/rfc3481.txt 


1.4 


External API Documents 


http://manpages.courier-mta.org/htmlman2/getsockopt.2.html 


1.5 


None 


1.6 


None 


Plug-in Extension Point Interface 


Other Interfaces 
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1.7 Other Notes 


The API for selecting the stack is the standard Linux kernel setsockopt API with the LiMo defined option 
SO WTCP. 


int setsockopt (int s , int level , int optname , const void * optval , socklen_t optlen ); 


optname = SO_WTCP Valid optvals are: optval =0 for standard TCP optval = 1 for WTCP 


Errors: If an implementation does not support WTCP at all, ENOPROTOOPT error will be returned as per 
normal set sockopt API. If an invalid option value is used, EINVAL error is returned as per normal 
setsockopt API. 


If a LiMo platform does not support WTCP stack selection, which is a vendor choice, then this API will 
return ENOPROTOOPT. 


The SO_WTCP definition (vendor specific) has to be resolved. It is the vendor’s responsibility to ensure 
that SO_WTCP is defined and does not clash with another option. 


Ex.1: Specify the kernel header file in the environment you used to build the kernel with —I compile option. 
#gcc .... -Ikernel_source_top/include .... 
Ex.2: Specify the value for SO WTCP directly with -D compile option. 


#gcc .... -DSO_WTCP=40 .... 
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File Index 


2.1 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
Doxygen) 2 eo et eh eee SA a Shee Eo hake Sed A 


File Index 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


Chapter 3 


File Documentation 


3.1 ComponentOverview.h File Reference 


3.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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